home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1994 October / Macformat17.cdr / Shareware in MacFormat / Translation package v1.52 / BitMapsToEPS V3.10 / BitMapsToEPS V3.10.rsrc / TEXT_129_help.txt < prev    next >
Text File  |  1993-11-11  |  11KB  |  241 lines

  1.     
  2.                   BitMap To EPS V3.00
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               E-mail: markf@post.Queensu.ca
  12. ==================================================
  13. BitMapToEPS History...
  14. Version 1.0 - EPS, MacPaint, and PICT reading routines
  15. Version 1.1 - Added Claris XTND interface to allow for external Translators.
  16. Version 2.0 - Changed name to: "BitMapsToEPS",  Added QuickTime support.
  17. Version 2.0.1 - Fix Bounding Box bug when saving selected area as EPS file.
  18.                        - Fix memory leak bug when saving PICT files
  19.                        - Resize window to size of image
  20.                        - cleaned up scrolling of image a little bit
  21.                        - Set selection rectangle to the whole imaPpicture is opened.
  22.                        - added QuickTime Preview & Opening of PICT files
  23.                        - added rotation of selected area, and support for B&W paste option.
  24.                        - Fix menu states (eg. enable menu item only when they are valid).
  25.                        Bugs reported by:  John Rawnsley <jhr%maths.warwick.ac.uk>
  26. Version 2.0.2 - Fix Suggested file names bug which occured after open QuickTime movie.
  27.                        - Added Help Item to System 7 Help menu
  28.                          Suggestion/Bug report from:
  29.                          Maynard Handley <maynard@helios.TN.Cornell.edu>)
  30. Version 2.1   - Added simple B&W Paint tools, and cleaned up code.
  31.                        - Added internal import filter for .BMP (Windows & OS/2) BitMaps
  32. Version 3.0   - Added EPSI (Encapsulated PostScript Independed) output code.  
  33.                           If Macintosh Preview is not selected EPSI is output.
  34.                         - Added reading B&W TIFF images  (uncompressed TIFF, 
  35.                           LZW compressed TIFF, PackBits  compressed TIFF, and CCITT 1D  compressed TIFF)
  36.                         - Added reading 4 & 8bit Grey Scale TIFF images  (uncompressed TIFF, 
  37.                           LZW compressed TIFF, and PackBits  compressed TIFF)
  38.                         - Added reading 4 & 8bit Palette TIFF images  (uncompressed TIFF, 
  39.                           LZW compressed TIFF, and PackBits  compressed TIFF)
  40.                         - Enable option not to convert to B&W.  
  41.                         - Added AutoSave function to aid file format conversion.
  42. ======================================================
  43. XTND, Copyright ¬© 1989-91 Claris Corporation
  44.  
  45. Converts the following Macintosh file formats to B&W Encapulated PostScript Files (EPSF) or B&W PICT files:
  46.  
  47. Built-in Import Translators:
  48. ‚Ä¢ MacPaint (B&W BitMap, 576 by 720)
  49. ‚Ä¢ StartUp Screens (B&W BitMap, 512 by 342)
  50. ‚Ä¢ PICT files (converted all PICT's to B&W BitMaps).
  51. ‚Ä¢ .BMP (Windows & OS/2) BitMaps.
  52. ‚Ä¢ QuickTime Movie player (when QuickTime is installed).
  53. ‚Ä¢ B&W, Grey Scale & Pallette TIFF images 
  54.   (uncompressed TIFF, LZW compressed TIFF, PackBits  compressed TIFF, and CCITT 1D compressed TIFF)
  55. See below for more detail description of file formats.
  56.  
  57. Supports XTND translators for importing graphics format as PICT's.  This requires "Claris XTND System" file, which comes with all Claris products and some other 3rd Party products.
  58.  
  59.  
  60. I have written a few XTND graphics translators, they are:
  61.  
  62. StartUpScreen V1.01 - Reads Macintosh B&W Bitmaps 512 by 342 startup screens.
  63. Windows (BMP) - Reads MS-DOS's Windows BMP bitmap format.
  64.  
  65. Click and Drag the selection rectangle in the picture to mark the area to be saved or edited.  Use "Select all" from the Edit menu to save the whole image.
  66.  
  67.  
  68. Edit Menu    
  69. Use Cut to copy the area in the selection rectangle to PICT in the Clipboard, and erase the selected area.
  70. Use Copy to copy the area in the selection rectangle to PICT in the Clipboard.
  71. Use Paste to paste a PICT at the top, left corner of the selection rectangle.  If the option key is depressed, the picture is scaled to the selected rectangle.
  72. Use Clear to erase the selected area.
  73. Use Select All to select the entire image.
  74.  
  75. Use rotate to rotate the selected area 90 degrees clockwize, the rotated image becomes the selected area.  Hold down the option key to retain the old selected area.
  76.  
  77. Paint Tools:
  78. Pen - draw in current pen pattern & width.
  79. Erasor - Erase an area of the picture.
  80. Line - draw lines.
  81. Selection rectangle - select the area to cut, copy, clear or rotate.
  82. Draw rectangles, round corner rectangles, and ovals in current pen pattern, width. If filled tool fill in current fill pattern.
  83.  
  84. Hold the option  key down while painting to "Or" the line, rect, etc with background image.
  85.  
  86. Options Dialog    
  87.  
  88. Use the "Preferences..." item in the Edit menu to set prefernces.  Defaults settings are displayed below:
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. This application support's System 7.0 "document dropping" feature.  To use this feature, drag one or more documents you would like to view onto the application, and release the mouse button when it is hilighted.
  114.  
  115. The option to convert Color to B&W bitmap, is normally enabled.  If it is not checked off, you can save a Color PICT of the image and also display the color version of the B&W image, but no editing.  Holding down the Option key will scale the image to the size of  the current window.
  116.  
  117. The Auto Save function is to aid in file format conversion.  When select a file to be opened either by 'Drag & Drop' or Open menu item.  The auto save function will automatically prompt you to save the file under the last file format you used.  
  118.  
  119. Default format is PICT, if you have not saved one.  
  120. Note: Last format saved will be checked off in the save sub-menu.
  121.  
  122. Current version does NOT include:
  123. ‚Ä¢ the option to copy EPS file in the clipboard.
  124. ‚Ä¢ No option to convert Color PICT to Grey Scale EPS BitMaps.
  125. ‚Ä¢ No option to save Color Windows .BMP files.
  126.  
  127. StartUp Screens    
  128.  
  129. StartUp Screens  are B&W bitmaps with a size of 512 by 342.  The bitmap is stored on disk uncompressed.
  130.  
  131. This program converts all PICT files to B&W bitmaps coresponding to the original size.   It will save the selected area of the bitmap as a EPS file or a PICT file.
  132.  
  133. Macintosh File Type of: SCRN
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141. MacPaint - B&W BitMaps    
  142.  
  143. MacPaint bitmaps are compressed black & white bitmaps with a size of 576 by 720.
  144.  
  145. This program converts all PICT files to B&W bitmaps coresponding to the original size.   It will save the selected area of the bitmap as a EPS file or a PICT file.
  146.  
  147. Macintosh File Type of: PNGT
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155. PICT    
  156.  
  157. PICT file are the Macintosh native picture format.  It is storable as a resource of type 'PICT' or as a data file of type 'PICT'.  It is object oriented, and contains all the quick draw commands used to draw the image on the Macintosh screen (Font: Size, Style, type; Lines, circles, BitMaps, etc...).   
  158.  
  159. This program converts all PICT files to B&W bitmaps coresponding to the original size.   It will save the selected area of the bitmap as a EPS file or a PICT file.  If QuickTime is install, preview image can also be saved with it.  Selectable from the Options Dialog box. 
  160.  
  161. Macintosh File Type of: PICT
  162.  
  163.  
  164.  
  165.  
  166.  
  167. EPSF - Encapulated PostScript Files    
  168.  
  169. Encapulated PostScript files are special PostScript programs with a special header describing the width and height of the image described by program.   
  170.  
  171. Preview images on the Macintosh are stored in a 'PICT' resourses ID 256 in the resource fork of the Macintosh fille.  Other platforms create PostScript comments with a low resolution hex dumps of bitmap as a preview image.  This is what is created if Macintosh Preview image is not included.  A third type of preview image, currently not supported is MSDOS Preview image using a 24 byte header.  This header describes the offset and size of the PostScript program and the preview image. 
  172.  
  173. The selected area of the bitmap is saved as a Black & White bitmap in an EPS file format.  This program only creates Macintosh 'PICT' preview images, selectable from the Options Dialog box. 
  174.  
  175. Macintosh File Type of:  EPSF or TEXT
  176.  
  177.  
  178.  
  179. TIFF File format:    
  180.  
  181. TIFF file have many formats:  Black and white, grayscale, full color (24-bit), and palette color (4-bit and 8-bit) images.  TIFF files support the uses of data compression using:  LZW, PackBits, and CCITT 1D compression (PackBits and CCITT 1D are allowed on black-and-white images only), LZW can be used with any image type.  
  182.  
  183. To complicate matters, two byte orders are supported:  'II' (intel) and 'MM' (Motorla), as indicated by the TIFF file header. 
  184.  
  185. Macintosh File Type of:  TIFF
  186.  
  187.  
  188.  
  189.  
  190. X11 File format:    
  191.  
  192.  The width and height of the bitmap are written as preprocessor symbols at the beginning of the file.  The bitmap image is then written as an array of characters. 
  193.  Here is an example of a bitmap file whose image spells X11.
  194.  
  195.         #define name_width 11
  196.         #define name_height 5
  197.         static char name_bits[] = {
  198.             0x91, 0x04, 0xca, 0x06, 0x84,
  199.             0x04, 0x8a, 0x04, 0x91, 0x04
  200.         };
  201.  
  202. Macintosh File Type of:  TEXT
  203.  
  204.  
  205. QuickTime‚Ñ¢    
  206. MooV - Movie file    
  207.  
  208. The Open... item in the File menu will play the selected QuickTime movie, in its ownn window.  You can use all the standard edit menu functions (Cut, Copy, Paste, and  Clear), but only resources of type "Moov"  can be pasted into a movie.
  209.  
  210. NOTE: This option requires QuickTime Exstension to be installed in the System Folder.
  211.  
  212.  
  213. Macintosh File Type of:  MooV
  214.  
  215.  
  216.  
  217. Picture file Compression    
  218.  
  219. QuickTime comess with routines for compressing files.  Any application that uses PICT files on Macintosh with QuickTime installed can de-compress these files.   
  220.  
  221. ‚Ä¢¬†The preview image is stored in the files as a PICT resource file.
  222.  
  223. I did not write the QuickTime code.  Most of it is from Apple's sample code, repackaged to work with this application.  The Movie playing is from  "Mini Edit Movie Stuff.c" and Compression code is from "SampleCompressPicture.c" both  slightly modified.  
  224.  
  225.  Thank you QuickTime development team & Apple DTS.
  226.  
  227. ‚Ä¢¬†Custom ICON's are created and stored in the resource file which System 7 finder will display.  
  228.  
  229.  
  230. This on-line help    
  231.  
  232. This on-line help was created by James W. Walker's Show_help help library.  For more information on the help libary contact James W. Walker at:
  233.  
  234. e-mail:    CompuServe:  76367,2271
  235.                           Internet:  76367.2271@compuserve.com
  236.                America Online:  JWWalker
  237.  
  238. U.S. mail:  James W. Walker        or   James W. Walker
  239.                   3200 Heyward Street       Department of Mathematics
  240.                   Columbia, SC 29205        University of South Carolina
  241.                                                             Columbia, SC 29208